Micro HDMI

Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.

---

本文档介绍 Quectel Pi M1 / L1 Debian 系统下 Micro HDMI 显示接口的连接、识别、显示设置、触摸使用和音视频播放方法。本文以外接 Micro HDMI 显示屏为例进行说明。

概述

Micro HDMI 是常用的音视频输出接口，适用于桌面显示、媒体播放、调试操作、工业看板和人机交互终端等场景。Quectel Pi M1 / L1 提供 1 路 Micro HDMI 2.0 接口，可连接 Micro HDMI 显示器进入 Debian 桌面环境。M1 默认进入 GNOME 桌面，L1 默认进入 Weston 桌面。

Quectel Pi M1 / L1 显示相关接口如下表所示：

接口	说明
Micro HDMI	1 路 Micro HDMI 接口，Micro HDMI 2.0。显示模式由系统、显示器 EDID 和线缆共同协商。
触摸	若 Micro HDMI 屏幕支持触摸功能，通常需要额外连接 USB 触摸线。

硬件接口

Micro HDMI屏幕连接

将 Micro HDMI 显示屏连接到开发板的 Micro HDMI 接口，并确认显示屏供电正常、Micro HDMI 线缆连接牢固。

M1 / L1 Micro HDMI 屏幕连接示意图：

连接注意事项：

1. 连接 Micro HDMI 显示屏前，建议先关闭开发板电源。

2. 确认 Micro HDMI 线缆方向正确，避免接口受力。

3. 确认显示器已经切换到对应 Micro HDMI 输入源。

4. 若使用带触摸功能的 Micro HDMI 屏幕，需要同时连接屏幕的 USB 触摸线。

触摸连接

若 Micro HDMI 屏幕支持触摸功能，请将屏幕的 USB 触摸接口连接到开发板的 USB Host 接口。系统识别触摸设备后，可直接在 Debian 桌面中进行点击、拖动和窗口操作。

M1 / L1 Micro HDMI 触摸连接示意图：

快速开始

1. 关闭开发板电源。

2. 将 Micro HDMI 线缆连接到开发板和 Micro HDMI 显示屏。

3. 打开 Micro HDMI 显示屏电源，并选择对应 Micro HDMI 输入源。

4. 给开发板上电。

5. 系统启动后进入 Debian 桌面。M1 进入 GNOME 桌面，L1 进入 Weston 桌面。

6. 如需确认系统状态，可在开发板终端执行：

hostname -I
cat /sys/class/drm/card0-Micro HDMI-A-1/status
cat /sys/class/drm/card0-Micro HDMI-A-1/modes

M1 Micro HDMI 桌面显示效果：

L1 Micro HDMI 桌面显示效果：

功能使用（GNOME）

以下功能基于 M1 GNOME 桌面环境。

触摸功能

连接 Micro HDMI 屏幕的 USB 触摸线后，可直接在 Debian 桌面中使用触摸功能。若触摸无响应，请优先检查 USB 触摸线是否连接到 USB Host 接口，并重新插拔后查看系统是否识别到输入设备：

lsusb
cat /proc/bus/input/devices

视频播放功能的使用方法

可先将测试视频推送到开发板的 Videos 目录：

adb push /home/q/work/temp/test-1.mp4 /home/q/Videos/m1-Micro HDMI-display-test.mp4

可视化界面的视频播放功能：在 Debian 桌面中，可通过文件管理器进入 Videos 目录，双击 m1-Micro HDMI-display-test.mp4 进行播放。

GStreamer命令行操作的视频播放功能：在使用命令行播放视频时，可输入以下命令。

gst-launch-1.0 playbin uri=file:///home/q/Videos/m1-Micro HDMI-display-test.mp4

以下为 GStreamer 命令行播放视频的效果图。

音频播放功能的使用方法

可先将测试音频推送到开发板的 Music 目录：

adb push /home/q/work/temp/test.mp3 /home/q/Music/m1-Micro HDMI-audio-test.mp3

可视化界面的音频播放功能：在 Debian 桌面中，可通过文件管理器进入 Music 目录，双击 m1-Micro HDMI-audio-test.mp3 进行播放。

GStreamer命令行操作的音频播放功能：在使用命令行播放音频时，可输入以下命令。

gst-launch-1.0 playbin uri=file:///home/q/Music/m1-Micro HDMI-audio-test.mp3

以下为 GStreamer 命令行播放音频的效果图。

音频输出检查

若 Micro HDMI 视频播放正常但没有声音，可先查看音频服务和默认输出设备：

pactl info

如果系统中存在多个音频输出设备，可在 GNOME 桌面右上角快捷设置中切换输出设备，或进入 Settings > Sound 查看音频输出配置。

功能使用（Weston）

以下功能基于 L1 Weston 桌面环境。

触摸功能

连接 Micro HDMI 屏幕的 USB 触摸线后，可直接在 Debian 桌面中使用触摸功能。若触摸无响应，请优先检查 USB 触摸线是否连接到 USB Host 接口，并重新插拔后查看系统是否识别到输入设备：

lsusb
cat /proc/bus/input/devices

视频播放功能的使用方法

可先将测试视频推送到开发板的 Videos 目录：

adb push /home/q/work/temp/test-1.mp4 /home/q/Videos/l1-Micro HDMI-display-test.mp4

GStreamer命令行操作的视频播放功能：在使用命令行播放视频时，可输入以下命令。

gst-launch-1.0 playbin uri=file:///home/q/Videos/l1-Micro HDMI-display-test.mp4

以下为 GStreamer 命令行播放视频的效果图。

音频播放功能的使用方法

可先将测试音频推送到开发板的 Music 目录：

adb push /home/q/work/temp/test.mp3 /home/q/Music/l1-Micro HDMI-audio-test.mp3

GStreamer命令行操作的音频播放功能：在使用命令行播放音频时，可输入以下命令。

gst-launch-1.0 playbin uri=file:///home/q/Music/l1-Micro HDMI-audio-test.mp3

以下为 GStreamer 命令行播放音频的效果图。

进阶功能

Micro HDMI屏幕热插拔

Micro HDMI 支持热插拔。系统运行过程中插入 Micro HDMI 显示屏后，系统通常会自动识别显示器并输出画面。

热插拔使用方法：

1. 在系统运行状态下，将 Micro HDMI 显示屏连接到开发板的 Micro HDMI 接口。

2. 等待系统自动检测显示设备。

3. 若画面未自动显示：M1 可进入 Settings > Displays 查看显示器是否被识别；L1 可通过 /sys/class/drm/card0-Micro HDMI-A-1/status 查看显示器是否被识别。

4. 如需断开 Micro HDMI 显示屏，可直接拔出 Micro HDMI 线缆。

命令行状态查看

常用排查命令如下：

# 查看 Micro HDMI 连接状态和支持的显示模式
cat /sys/class/drm/card0-Micro HDMI-A-1/status
cat /sys/class/drm/card0-Micro HDMI-A-1/modes

# 查看系统日志中的显示相关信息
journalctl -b | grep -Ei 'Micro HDMI|drm|display|edid'

# 查看音频默认输出设备
pactl info

应用场景

• 媒体娱乐终端：通过 Micro HDMI 显示屏播放视频、音乐或展示图片。

• 工业数据可视化平台：用于显示设备状态、传感器数据、仪表盘和告警信息。

• 智能交互终端：搭配触摸 Micro HDMI 屏幕实现本地菜单、控制面板和人机交互界面。

• 开发调试显示终端：连接常见 Micro HDMI 显示器后，可直接查看 Debian 桌面和调试信息。

疑难解答

现象	可能原因	处理方法
开机后黑屏	显示器未上电、输入源选择错误、Micro HDMI 线缆未插紧，或系统未完成启动	检查显示器供电和输入源；重新插拔 Micro HDMI 线缆；通过串口或 ADB 查看系统是否正常启动。
热插拔后无画面	系统未及时识别 Micro HDMI 设备，或显示器 EDID 读取异常	等待数秒后查看连接状态：M1 进入 Settings > Displays 查看显示器；L1 执行 cat /sys/class/drm/card0-Micro HDMI-A-1/status。必要时重新插拔 Micro HDMI 线缆或重启系统。
分辨率异常	显示器 EDID 识别异常、线缆质量不佳，或当前显示器不支持系统协商的模式	更换 Micro HDMI 线缆或显示器；M1 进入 Settings > Displays 手动选择可用分辨率；L1 执行 cat /sys/class/drm/card0-Micro HDMI-A-1/modes 查看当前可用显示模式。
屏幕花屏或闪烁	Micro HDMI 线缆质量不佳、接口接触不良或受到干扰	更换质量更好的 Micro HDMI 线缆；确认接口插紧；避免线缆靠近强干扰源。
触摸无响应	USB 触摸线未连接、接错接口，或系统未识别输入设备	检查 USB 触摸线连接；执行 lsusb 和 cat /proc/bus/input/devices 查看触摸设备是否被识别。
视频无法播放	视频编码不受当前播放器支持，或文件路径错误	确认视频文件已存在于 /home/q/Videos/；M1 尝试使用 GNOME 视频播放器或 GStreamer；L1 尝试使用 GStreamer 播放常见 H.264 MP4 测试视频。
视频有画面无声音	音频输出设备选择错误、音量被静音，或显示器不支持当前音频输出	M1 检查右上角声音设置，进入 Settings > Sound 切换输出设备；执行 pactl info 查看默认输出设备。L1 确认音频设备已连接，并确认音量未静音。